home *** CD-ROM | disk | FTP | other *** search
/ CD Ware Multimedia 1995 May / cd Ware (Juegos) Epimundo.iso / WIN / VB_CTRLS / KNOBVBX.ZIP / README.TXT < prev    next >
Encoding:
Text File  |  1994-03-19  |  6.3 KB  |  208 lines
  1. ----------------------------------------------------------------
  2.  
  3.                         Knob VBX Control  
  4.  
  5.               Copyright 1994 Northeast Data Corp.
  6.  
  7.                      All Rights Reserved
  8.  
  9. ----------------------------------------------------------------
  10.  
  11.  
  12.    Release 1.0
  13.  
  14.    March 1994
  15.  
  16.  
  17. This document describes the Knob Custom VBX Control. 
  18.  
  19.  
  20.                CONTENTS
  21.  
  22. 1. Product Description
  23. 2. Legal Information
  24. 3. Installation
  25. 4. Usage
  26. 5. Ordering Information
  27.  
  28. ----------------------------------------------------------------
  29.  
  30. 1. Product Description
  31.  
  32. The Knob VBX Control is a Microsoft Windows DLL designed and 
  33. implemented in compliance with Microsoft standards for
  34. interfacing with Visual Basic.
  35.  
  36. The control appears to the end user as a knob similar to those 
  37. used on audio/video equipment such as stereos, tuners, and amplifiers.
  38.  
  39. To the application programmer, the interface to the knob is similar
  40. to the one for the MS Windows standard scroll bar. The programmer can
  41. set a range of values that will be fed back to the application as the
  42. end user adjusts the position of the knob.
  43.  
  44. Being a VBX control, the programmer can add the Knob Control to the 
  45. tool palette in Visual Basic. This allows use of the control in Visual
  46. Basic forms. Since Visual C++ supports use of VBX controls, the knob
  47. control can also be used in the Visual C++ environment.
  48.  
  49. Use of the Knob Control in a finished application requires the
  50. Knob Control DLL (knob.vbx) to be installed with the application.
  51. This is true of all custom controls written for MS Windows.
  52.  
  53. There are properties available that allow the programmer to control
  54. the behavior and appearance of the knob Control. The knob can use
  55. a dot or a line as a pointer.  The knob can increment it's values
  56. in either a clockwise or counter clockwise direction.  The knob can 
  57. also specify the range of degrees used for rotation.  This feature
  58. allows the knob to rotate several times before reaching it's stop.
  59.  
  60. The range of the knob can be set to any range with low and high values
  61. varying from 0 to 32767.
  62.  
  63. All communication between the Knob Control and the application is 
  64. performed using the standard Windows message mechanism for controls. 
  65. Design of the knob Control message mechanism allows the application to
  66. continuously monitor the setting of the control.
  67.  
  68.  
  69. -------------------------------------------------------------------
  70.  
  71. 2. Legal Information
  72.  
  73. The purchaser of the Knob Control is allowed to use it and
  74. distribute it in applications without paying any royalty, and without
  75. printing or displaying a copyright notice for the control. This only
  76. includes distribution of the Knob Control DLL (KNOB.VBX). It does 
  77. not include distribution of documentation that comes with the Knob 
  78. Control. 
  79.  
  80. The purchaser of the Knob Control may distribute the control DLL with
  81. applications that are networked (multiple users accessing the DLL from
  82. a file server) without paying any license fees to Northeast Data Corp.
  83.  
  84.  
  85. -------------------------------------------------------------------
  86.  
  87. 3. Installation
  88.  
  89. Create a "knob" directory on your hard disk and copy all files from
  90. the distribution disk to the directory. These files include:
  91.  
  92.  
  93.    KNOB.VBX       
  94.    FORM1.FRM       
  95.    PROJECT1.MAK       
  96.    README.TXT       
  97.    VBTEST.EXE 
  98.  
  99. If you have downloaded the knob1.zip file from Compuserve, use
  100. PKUNZIP to extract the files into the directory.
  101.  
  102. Start Visual Basic or the Visual C++ App Studio applications and use
  103. the custom control installation function to install the knob.vbx
  104. control.
  105.  
  106.  
  107. -------------------------------------------------------------------
  108.  
  109. 4. Usage
  110.  
  111.  
  112. PROPERTIES
  113. ----------
  114.  
  115.    BackColor - Sets the background color.
  116.  
  117.    DegreeMax - The maximum degree value used during rotation (long).
  118.  
  119.    DegreeMin - The minimum degree value used during rotation (long).
  120.  
  121.    Delay     - The number of milliseconds used for the delay while
  122.                holding the left mouse button down.
  123.  
  124.    Direction - The direction used to increment the value of the knob.
  125.                0 - Normal (clockwise) 1 - Reversed (counter clockwise).
  126.  
  127.    FaceColor - Sets the color of the knob face.
  128.  
  129.    Height    - Height of control.
  130.    
  131.    HighlightColor - Sets the outer bevel color.
  132.  
  133.    KnobType  - 0 - Point, 1 - Line
  134.  
  135.    Left      - Left position.
  136.    
  137.    Max       - Maximum knob value. This must be greater than the
  138.                minimum knob value.
  139.  
  140.    Min       - Minimum knob value. This must be less than the maximum
  141.                knob value.
  142.  
  143.    PointColor - Sets the color of the point or line.
  144.  
  145.    Pos       - Current knob position. This must be a value between
  146.                or including the current minimum and maximum values of
  147.                the knob.
  148.  
  149.    ShadowColor - Sets the color of the focus bevel.
  150.  
  151.    TabStop   - If this is turned on (1 instead of 0), the knob can
  152.                be activated by tabbing to it with the TAB key.
  153.  
  154.    Tag       - Control tag.
  155.  
  156.    Top       - Top of control window.
  157.  
  158.    Visible   - Visible/Invisible attribute.
  159.  
  160.    Width     - Width of control.
  161.  
  162.    
  163. EVENTS
  164. ------
  165.  
  166. These events work the same way as for other VBX controls.
  167.  
  168.    DblClick 
  169.    DragDrop  
  170.    DragOver
  171.    GotFocus
  172.    KeyDown
  173.    KeyUp
  174.    LostFocus
  175.    LMouseDown  - Occurs when the left mouse button is pressed down
  176.    LMouseUp    - Occurs when the left mouse button is released
  177.    ValueChanged - Occurs when the value of the knob has changed
  178.  
  179. In order to update values in your application based on the current
  180. position of the knob control, you should handle the ValueChanged
  181. event.
  182.  
  183.  
  184. Ordering Information
  185. --------------------
  186.  
  187. To order the commercial version of the Knob Control, send a check to:
  188.  
  189.    Northeast Data Corp.
  190.    2117 Buffalo Rd., Suite 290
  191.    Rochester, NY  14624
  192.  
  193. The prices are:
  194.  
  195.    Knob VBX Control (for Visual Basic and Visual C++)    - $55
  196.    
  197.    Knob DLL Custom Control (for C)                       - $50
  198.  
  199.    Both controls                                         - $75
  200.  
  201.    Source code (includes both controls)                  - $235
  202.  
  203.  
  204. Include your phone number and Compuserve ID if applicable. In return for
  205. your check, you will get the software, a telephone number for support, and
  206. a Compuserve ID for support.
  207. 
  208.